home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games: Greatest Hits 1996 / Amiga Games: Greatest Hits 1996.iso / spiele / publicdomain / wormalyzer / wormalyzer.doc < prev    next >
Text File  |  1996-05-26  |  6KB  |  164 lines
  1. Wormalyzer V1.0    26/5/1996
  2. ----------------------------
  3.  
  4. What Is The Wormalyzer?
  5. -----------------------
  6.  
  7.    The wormalyzer is a small program to analyse custom worms levels and give
  8. some information on them, as an indication of how they'll play.
  9.  
  10. But Why?
  11. --------
  12.  
  13.    Erm, good question, I did this mainly to practice using gadtools and
  14. asl with blitz basic, and because i like worms!  Even if the program is a
  15. tad pointless :)
  16.  
  17. What Do I Need To Run It?
  18. -------------------------
  19.  
  20.    Well, as it's written using the gadtools interface and uses the asl file
  21. requester, you'll need at least wb2.x to use it.  So far It's only been
  22. tested on an a1200 with 020 and 2 meg fast, 2 meg chip.
  23.    Chances are you'll need asl.library (maybe gadtools.library as well)
  24.  
  25.  
  26. So, How Do I Use It?
  27. --------------------
  28.  
  29.    Double click on it's icon to start it, then click on load.  This brings
  30. up a file requester, with which you should select a .WRM file.
  31.    Once you've done this the program gets on with analyzing it, which can
  32. take a minute or two.
  33.    If it's the first time you have used it, a file called wormalyze.dat
  34. will be created in the current directory to store the path in, when you
  35. quit.
  36.  
  37. Ok, It's Done, So What Do The Numbers Mean?
  38. -------------------------------------------
  39.  
  40.    Each number refers to an aspect of the level:
  41.  
  42.    Total : The total number of non-background pixels in the level
  43.  
  44.    Top,Bottom,Left,Right : These refer to the number of pixels in each
  45.                            of the sections, thusly;
  46.  
  47.                 ______________________________________
  48.                |                  |                   |
  49.                |                  |                   |   Top
  50.                |                  |                   |
  51.                |__________________|___________________|
  52.                |                  |                   |
  53.                |                  |                   |
  54.                |                  |                   |   Bottom
  55.                |__________________|___________________|
  56.  
  57.                     Left                 Right
  58.  
  59.                 This gives an indication as to the weighting of the level.
  60.  
  61.    Surface : The number of pixels available to stand in at the start of the
  62.              game (ie, before bits have been blown off :)
  63.  
  64.    Highest : The highest point in the level (Maximum height is 350)
  65.  
  66.    Lowest  : The Lowest point in the level (Minimum is 0)
  67.  
  68. Ok, so whats the difference between pixel and percentage?
  69. ---------------------------------------------------------
  70.  
  71.    The cycle gadgets let you switch from pixels to a percentage.
  72.    The total can be displayed as number of pixels, or as a percentage of
  73.    the total number possible (which is 336000 pixels)
  74.    The other stats can be displayed as number of pixels, or as a percentage
  75.    of the total (whatever that may be).
  76.    The surface is always shown as the number of pixels, and the highest and
  77.    lowest points would make no sense as percentages.
  78.  
  79. I Get 'Error' In The Status Box, Why?
  80. -------------------------------------
  81.  
  82.    Well, until I can code a better error routine, it could be one of several
  83. things:
  84.  
  85.        Does the file you've chosen exist?
  86.        Is the file an iff of the right size?
  87.        Is there enough memory left to load it?
  88.  
  89. Possible Enhancements.
  90. ----------------------
  91.  
  92.    Lots to do, I hope to add:
  93.  
  94.       Better error messages :)
  95.       More stats
  96.       Some kind of comment, eg 'This level will be over quick'
  97.       Ability to alter levels comment and sky/water colours
  98.  
  99. History
  100. -------
  101. 26/5/96 V1.0
  102.  
  103.    Due to this programs immense popularity :) I've decided to upload it to
  104.    Aminet.  No major changes, but the code is more stable, and a few of the
  105.    gadgets have been tweaked to make it all a bit more intuitive.  Slightly
  106.    better error checking too...
  107.  
  108. 13/5/96 V0.22
  109.  
  110.    Turned out the bug wasn't fixed after all, should be now though.
  111.    It was a problem with the way blitz opens windows, A font with a point
  112.    size different to 8 in the drag bar screwed up the opening of the window
  113.    and positioning of the gadgets, bizzare.
  114.  
  115. 9/5/96 V0.21
  116.  
  117.    Attempted to fix bug that made window open incorrectly, should be ok now
  118.  
  119. 8/5/96 V0.2
  120.  
  121.    Fixed bug in surface calculation, should get it right now.
  122.    Added progress meter, and option to view as percentages.
  123.    Added storage of path in a data file.
  124.    Added level name display.
  125.  
  126. 4/5/96 V0.1 beta
  127.  
  128.    First public release.  Only available from My Web Site.
  129.  
  130. Disclaimer
  131. ----------
  132.  
  133.    If this Blitz program eats your hard drive, or destroys your disks then
  134. it ain't my fault, it works fine on my a1200...
  135.    If you DO find any bugs, I'd like to know about them...
  136.  
  137. Contacting The Author
  138. ---------------------
  139.  
  140.    At the present moment the best way to contact me is via e-mail:
  141.  
  142.    csuxf@csv.warwick.ac.uk
  143.  
  144.    I also have a worms homepage, which contains this and a few levels...
  145.  
  146.    http://www.csv.warwick.ac.uk/~csuxf/wormspage.html
  147.  
  148.    And if you're into talk of the live kind, i can normally be found on
  149.    the efnet irc channel #amiga as Flabio.
  150.  
  151.             ___________________/\_____________o KEEP ON WORMING.....
  152.  
  153. Greetings to:
  154. -------------
  155.  
  156.    Andy Davidson              : Mr. Worms himself.
  157.    Neure, Billriker and [Ted] : Blitz gurus one and all.
  158.    CMU and Benefacto          : Beta testers, and bug spotters.
  159.    Perty and F1Oli            : For helping me figure out the drag bar bug
  160.    JiMBoB and FiReST0RM       : General encouragement.
  161.    Worms players              : For downloading this program :)
  162.    Sillytuna                  : For XTreme Racing.
  163.  
  164.